package com.journal.book.service;

import com.journal.book.domain.JournalLocation;
import java.util.List;

/**
 * 期刊定位记录Service接口
 *
 * @author mobin
 * @date 2025-01-XX
 */
public interface IJournalLocationService
{
    /**
     * 记录期刊定位
     * 
     * @param journalCode 期刊编号或名称
     * @param shelfId 书架ID
     * @param sideId 书架侧面
     * @param level 书架层数
     * @param userIdentifier 用户唯一标识（可选）
     * @param ipAddress IP地址（可选）
     * @param location IP所在地区（可选）
     * @param brand 手机品牌（可选）
     * @param model 设备型号（可选）
     * @param osName 操作系统名称（可选）
     * @return 结果
     */
    public int recordJournalLocation(String journalCode, String shelfId, String sideId, Long level,
                                     String userIdentifier, String ipAddress, String location, 
                                     String brand, String model, String osName);

    /**
     * 查询期刊定位记录
     *
     * @param id 期刊定位记录主键
     * @return 期刊定位记录
     */
    public JournalLocation selectJournalLocationById(Long id);

    /**
     * 查询期刊定位记录列表
     *
     * @param journalLocation 期刊定位记录
     * @return 期刊定位记录集合
     */
    public List<JournalLocation> selectJournalLocationList(JournalLocation journalLocation);

    /**
     * 新增期刊定位记录
     *
     * @param journalLocation 期刊定位记录
     * @return 结果
     */
    public int insertJournalLocation(JournalLocation journalLocation);

    /**
     * 修改期刊定位记录
     *
     * @param journalLocation 期刊定位记录
     * @return 结果
     */
    public int updateJournalLocation(JournalLocation journalLocation);

    /**
     * 批量删除期刊定位记录
     *
     * @param ids 需要删除的期刊定位记录主键集合
     * @return 结果
     */
    public int deleteJournalLocationByIds(Long[] ids);

    /**
     * 删除期刊定位记录信息
     *
     * @param id 期刊定位记录主键
     * @return 结果
     */
    public int deleteJournalLocationById(Long id);
}

